Release 10.1A: OpenEdge Development:
Progress Dynamics Web Development Guide

Updating the XML configuration file

The configuration file, icfconfig.xml, defines each session type so that the information is available to the Configuration File Manager at startup. The definition of each session type includes a list of required managers, session properties, and session services.

When you create an application, like the tutorial, you usually create an icfconfig.xml in the application’s work directory. When you modify a session type (like ICFWS) or create a new session type (like ICFWStut), you must update the application’s icfconfig.xml file.

To generate (or update) your XML configuration file:

Start a Progress Dynamics session that has administrative privileges.

For the tutorial application, use the shortcut that you used to start a development session for the tutorial.

From the Progress Dynamics AppBuilder Tools menu, select Administration.
From the Administration tool, choose Session Generate Configuration File to display a window like the following:



In the list of available session types in the left pane, select one or more entries and click Add. The selected types appear in the right pane.

You can include configuration information for multiple session types in a single file, but for this example, just select the session type that you created for the tutorial application.

Before you generate your configuration file, click the Browse button and select the appropriate directory as the target location for the file. The default icfconfig.xml file is installed in install_dir\gui\icf. Since you do not want to overwrite the default, you should generate an XML configuration file in your application’s work directory or some other location.

You might also want to give the XML file an identifiable name, icfconfigtut.xml for example. One advantage of specifying a different name is that you avoid confusion with the default XML configuration file. However, be sure that the filename has a .xml extension.

Click the Generate Config File button. The tool generates definitions for the selected session types and writes the information to the configuration file. A confirmation message appears when the generation is successful.
Choose the Close button to close the Generate Configuration XML file dialog box.
Close the Session Type Control window.
Close the Dynamics AppBuilder to exit the current Progress Dynamics session.
Stop and restart the Progress Dynamics DB servers.

For more information about XML configuration files, see OpenEdge Development: Progress Dynamics Administration .